home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / spitfire / dir2sf10.zip / DIR2SF.DOC next >
Text File  |  1993-04-29  |  4KB  |  96 lines
  1.   ───────────═══════ DIR2SF Directory List Converter ═══════───────────
  2.   ───────═══════════ Copyright 1993 by Kevin Cummins ═══════════───────
  3.  
  4.  
  5.                                Version 1.0
  6.  
  7.  
  8. What does DIR2SF do?
  9. ─────────────────────┘
  10. It will convert PCBOARD or FILES.BBS file listings to the Spitfire one-line
  11. format. It can optionally add a header at the top of the converted listing,
  12. with a CD name, File area number, and description.
  13.  
  14. The original file names can be retained if you are using a door
  15. program, or can be renamed to SFFILES.(X) for use as SF file area
  16. listings directly accessible thru Spitfire.
  17.  
  18. Why write this?
  19. ────────────────┘
  20. Well, after adding a CD-ROM to my BBS, I found that being able to convert
  21. these file lists was a necessity. I tried a couple other utilities that did
  22. conversions, but one would not remove the "|" character. You could do it
  23. manually or with a search/replace, but it was still awkward.
  24.  
  25. Another one did not accurately do the conversion to the actual Spitfire
  26. one-line format, although it advertised itself to. So, to save myself a
  27. bunch of time and headache, I wrote this to do it the way *I* wanted it
  28. done. And, I thought I might as well share it with anyone else who might
  29. have similar needs.
  30.  
  31.  
  32. Requirements & Notes for Successful Operation:
  33. ────────────────────────────────────────────────┘
  34. Files must be named DIR1, DIR2, DIR3, etc. in sequential order, and must
  35. start with DIR1. If a file is missing in the middle, then all successive
  36. files will not be processed. DIR2SF is written to handle up to 100 file
  37. areas per run. If you find this needs to be increased, please drop me a
  38. note.
  39.  
  40. A 'DIR<X>' file must exist for the program to execute. It looks for DIR1,
  41. which if missing causes the program to abort. Otherwise, execution
  42. continues until there is a break in the sequence of DIR<X> files.
  43.  
  44. DIR2SF must either be in the same directory as the files to process, or be
  45. in the DOS path.
  46.  
  47. DIR2SF does NOT create any backup files! If you want a backup, make one
  48. before running DIR2SF! Since these are CD-ROM lists, you should have
  49. another copy on there anyway, right?
  50.  
  51.  
  52. Installation & Usage:
  53. ──────────────────────┘
  54. Copy DIR2SF to either a location in your DOS path, or to the directory
  55. where your DIR<X> files will be found. At the DOS prompt, simply enter
  56. DIR2SF.
  57.  
  58. You will first be presented with the option to use the built-in header
  59. function. If you respond with <Y>es, then you will be prompted for the name
  60. of the CD that you are processing lists for. You will only have to enter
  61. this information once, as it is automatically entered for you for each
  62. list.
  63.  
  64. You will then be prompted whether to rename the DIR<X> files to
  65. SFFILES.<X>. Please note that the number given to each SFFILES.<X> file
  66. does NOT have to correspond to the number of the DIR<X> file. If you choose
  67. to use the rename function, you will be prompted for the directory number
  68. of each file as it is processed.
  69.  
  70. If you have chosen either of the two above mentioned options, processing
  71. will continue until all DIR<X> files have been processed, prompting you for
  72. the required information for each area.
  73.  
  74. If you do not choose the header or rename options, then DIR2SF
  75. automatically processes all DIR<X> files without your interaction.
  76.  
  77. I guess that's about all I can tell you. Pretty simple, so copy a couple
  78. test files somewhere and make a test run if you wish.
  79.  
  80.  
  81. Registration:
  82. ──────────────┘
  83. DIR2SF does not require any registration or fees. (if you really wanted to
  84. send a couple bucks, I guess that would be OK....:) You may distribute it
  85. freely in it's unmodified form, and use it as you see fit.
  86.  
  87. If you have any questions or comments regarding this program, I can be
  88. reached at:
  89.  
  90. Kevin Cummins                  Crimson Cross BBS        RIME Network
  91. 100 Humphrey Road                618-253-3608           Node: CCBBS
  92. Harrisburg, Il 62946             USR D/S 14.4                 #1390
  93.  
  94.  
  95.  
  96.